/*
 * not type checking this file because flow doesn't play well with
 * dynamically accessing methods on Array prototype
 */
/**
 * 处理数组的思路是覆盖数组对象的原生方法，在覆盖的方法中，检测数组的变化，
 * 并将变化发布到订阅者。
 */

import { def } from '../util/index'

const arrayProto = Array.prototype
export const arrayMethods = Object.create(arrayProto)

/**
 * Intercept mutating methods and emit events
 */
;[
  'push',
  'pop',
  'shift',
  'unshift',
  'splice',
  'sort',
  'reverse'
]
.forEach(function (method) {
  // cache original method
  const original = arrayProto[method]
  //在arrayMethods对象中添加所有重写的数组原生方法
  def(arrayMethods, method, function mutator (...args) {
    //调用原生方法获得结果，注意，this指向当前数组对象
    const result = original.apply(this, args)
    const ob = this.__ob__
    let inserted
    //如果是插入操作，需要获得插入的数据
    switch (method) {
      case 'push':
      case 'unshift':
        inserted = args
        break
      case 'splice':
        inserted = args.slice(2)
        break
    }
    /**
     * 对新插入的数据添加响应式。
     * 示例：
     * 一个组件的选项对象如下：
     * {
     *    data:{
     *        test:[{name:'one'}, {name:'two'}]
     *    },
     *    template:'<div>{{hello}}<button @click="clickOne">clickOne</button><button @click="clickTwo">clickTwo</button></div>',
     *    computed:{
     *        hello(){
     *            let result = '';
     *
     *            for(let i = 0;i < this.test.length;i++){
     *                result += this.test[i].name + ' ';
     *            }
     *
     *            return result;
     *        }
     *    },
     *    methods:{
     *        clickOne(){
     *            //向数组中新增了一个数据
     *            this.test.push({name:'three'});
     *        },
     *        clickTwo(){
     *            //在此事件中修改了新增的数据，则computed的hello属性中可以检测到这种改变，从而更新hello的值。
     *            this.test[2].name = 'four';
     *        }
     *    }
     * }
     * 另外，必须先对inserted中的新对象添加数据响应系统，因为之后调用的ob.dep.notify()语句会为这些对象添加
     * 相应的watcher，详情可查看defineReactive方法中的注释，特别是setter中的最后一个语句上的注释。
     */
    if (inserted) ob.observeArray(inserted)
    // notify change
    ob.dep.notify()
    return result
  })
})
